home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Libris Britannia 4
/
science library(b).zip
/
science library(b)
/
UTILITIE
/
CPU_MEMO
/
3468.ZIP
/
RAID12.ZIP
/
RAID.DOC
< prev
next >
Wrap
Text File
|
1988-11-08
|
10KB
|
257 lines
Resident AID Version 1.2
Copyright (C) 1988
Ross Neilson Wentworth
All Rights Reserved
Warranty
========
This software is provided without warranty of any kind, expressed
or implied. If you don't like it, don't use it - you didn't pay
for it!
Overview
========
Resident AID (RAID) is a resident popup program (TSR) designed to help
programmer's with a few menial tasks. This program provides four
functions:
1. ASCII table, a display of the entire character set with
the codes in both hexadecimal and decimal, plus a display
of what that particular value would look like if it were
used as an attribute.
2. Memory dump, any memory location may be displayed in one
of several formats, hexadecimal byte, hexadecimal word
decimal byte, decimal word, signed integer (two bytes),
and address (four bytes).
3. Find file, this function will search all subdirectories
on the disk for a given file, wild cards are allowed.
4. Scan code, pressing a key will display its scan code.
Extended scan codes will be returned if an enhanced
keyboard is detected.
Hardware Requirements
=====================
Any 100% compatible will work. This program also requires three pages
(49k) of expanded memory (EMM 3.2, 4.0, or EEMS). The bulk of this
program is placed in the expanded memory. Only about 1k of conventional
memory is consumed. This is one popup that you can afford to leave in
memory all of the time!
Installation
============
Copy RAID.COM and RAID.EMS to your boot disk in any subdirectory on your
'PATH='. Place in your AUTOEXEC.BAT file the command 'RAID' (without the
quotes). You should place this after the PATH= directive (if you have one).
When you boot your system the program will be loaded. When RAID.COM is
run it will search the current subdirectory and along the path for the
RAID.EMS file. Under DOS 3.x it will also look in the same subdirectory
that RAID.COM is in.
The following error messages mean that the program was not loaded into
program memory:
'Program already loaded.'
The program was already found in memory. Multiple copies are
redundant.
'Expanded memory driver not installed.'
Expanded memory is required for this program to run. Make sure
that you are properly loading the expanded memory driver before
attempting to load RAID.
'Expanded memory driver not working.'
The expanded memory driver has reported a fault with the
expanded memory board or with the driver. If you have
an expanded memory diagnostics program you should run it.
'Invalid EMS version number, requires version 3.2 or later.'
This program requires EMS version 3.2 or 4.0, or EEMS. The version
detected is none of these three. Contact your EMS board maker for
a software update.
'Insufficient expanded memory to load program.'
Not enough expanded memory is available. Other resident program's
may be using all or most of the expanded memory or you simply
don't have enough memory installed on the board.
'Error in initialization.'
This error is most probably caused by a conflict with another
resident program. Try changing your load order. If running
DOS 2.x, make sure that you load RAID before PRINT.COM.
'Overlay file not found: RAID.EMS'
The file RAID.EMS could not be found in the current subdirectory
or anywhere on the 'PATH'. Check your PATH directive and make
sure you have properly copied RAID.EMS.
Operation
=========
Once the program is properly loaded into memory you can pop up its main
menu by pressing CONTROL-5 (that's the '5' located on the numeric keypad
in the center). You can exit out of each level of the program by pressing
ESC, pressing ESC enough will exit out of RAID entirely, right back to
where you were.
A fast alternate way to exit from RAID back to the underlying program
is to press ALT-X. The next time you invoke RAID you will be back to
whichever operation you left.
The features of RAID can be divided into five distinct catagories:
1. Main menu, with clock/calander
2. Ascii/Attribute table
3. Memory dump
4. File finder
6. Keyboard scan code
Main Menu
=========
This window will display four selections, by pressing the first letter of
each selection (between the '()') you can select one of the operations of
RAID. The current time and date are also displayed.
Ascii/Attribute Table
=====================
Selection this operation displays a window of 32 characters, the hexadecimal
and decimal code for that character, and the display attribute if that number
code were used as an attribute. On the far right of the window is a descrip-
tion of the color for the foreground. On the bottom of the window is the
background color description. Both of these are suitable for use within a
Turbo Pascal source listing (e.g. TextColor(Blue)).
Users of monochrome displays will gain little from the attribute feature of
this window.
Pressing PgUp, PgDn, UpAr, or DnAr will page through the character set.
Pressing ESC will bring you back to the main menu.
Memory Dump
===========
This operation will display a dump of memory, 256 bytes at a time. You can
use the cursor keys to page through memory or you can directly enter a memory
address by first pressing F1. Another feature of this operation is the
ability to change how the memory is displayed. There are 6 different display
modes available:
Format Range
---------------- ------------------------
1. Hexadecimal byte 00h thru FFh
2. Hexadecimal word 0000h thru FFFFh
3. Decimal byte 0 thru 255
4. Decimal word 0 thru 65535
5. Decimal integer -32768 thru 32767
6. Address 0000:0000 thru FFFF:FFFF
To change the display mode press F2 to go to the next display format, or
F3 to use the previous display format.
Below the memory dump is a list of keyboard commands that are available.
File Finder
===========
This operation will search all subdirectories on a disk for a specified
file. Wildcards are fully supported, this allows the searching of
similar files that are scattered throughout your disk drive. For example,
entering *.WKS will search for all of your spreadsheet files, while RAID.*
will find all of the files named RAID regardless of the extension.
You can halt a search by pressing ESC. Pressing ESC while being prompted for
a file name will take you back to the main menu.
Keyboard Scan Code
==================
This operation simply prompts you for a key and displays its scan code. For
example, pressing ESC will display 011B, pressing F1 will display 3B00. To
return to the main menu you must press ESC twice.
Information
===========
This program was written using Turbo Pascal Version 5.0, Turbo Assembler
Version 1.0, and Microsoft MASM Version 5.1. Two different assemblers
were used because it was originally written with MASM 5.1 and it hasn't
been fully rewritten yet. All of the assembler routines that require
customization have been converted to TASM.
I would appreciate hearing you comments, suggestions, and bug reports.
Is there some feature that you would love to see implemented? Anyone
who makes a suggestion that I use will receive via U.S. mail a free
update disk. You can receive the latest version by sending $10 to the
address below to cover postage and handling. I am not planning on
making any money on the sell of this program. Even though $10 is
more than the stand mail rates, it helps pay for the time I must
spend to mail the buggers (I'm a self-employed programmer, and not
rich). It also means I won't be swamped by requests, I would rather
you get the program from the bulletin boards.
Ross Neilson Wentworth
Serendipity Software
1422 Elkgrove Circle, #3
Venice, CA 90291
I can also be reached through the Fido/Opus network at 1:102/345. I am
especially active on the PASCAL echo-mail area. This board is always
the first to receive the latest versions of all of my software.
WANT AD
=======
As mentioned above, I am a self-employed programmer. I have been
independent for less than a year (it is now NOV 1988, who knows when
you are reading this). I have yet to build up a large client base so
I still have lots of available time. If you need an expert Pascal,
preferrably Turbo Pascal, and expert assembler programmer for short-term
or long-term contract work, please contact me. Either write (to the
above address), send net-work mail (again, see above) or call:
(213)399-1244 10am - 7pm Pacific Time
I have worked on databases, graphics, CAM, menuing systems, resident programs,
programmer's toolkits -- to name just a few.
Letters of references are available. Sample source code is available
as well.
NOTE, the above phone number is only for paying work, either made-for-hire,
custom, or purchase of current work. It is not for technical support of
this program or any other program I have written and placed on the
bulletin board systems - unless you have registers!
Version History
1.1 4 November 1988
Corrected minor bug in the cursor shape restoration. Dumps memory
as it is before interrupt vectors are changed when the program
temporarily grabs hold. Added saving of the screen in the FIND FILE
routine so that you can pop out and back into the same list of files.
1.0 Original Version